home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1998 February / Macworld (1998-02).dmg / Inside Macworld / NetCloak 2.5.1 CD Demo / Upgrading < prev   
Text File  |  1997-11-18  |  3KB  |  45 lines
  1. Upgrading NetCloak
  2.  
  3. To ensure a smooth transition from NetCloak 2.1 or earlier, be sure to read these additional instructions after installing NetCloak 2.5
  4.  
  5. If you are using the NetCloak Plug-In, shut down your web server.
  6.  
  7. New "NetCloak Files" Folder
  8.  
  9. We've consolidated the location of all the various NetCloak auxiliary files, as well as the "NetCloak Preferences" file, into a new folder named "NetCloak Files", which is located in the same folder as the ACGI (if you're using the ACGI) or the web server application (if you're using the plug-in). Moving these "auxiliary" files and the preferences file into this folder now allows more than one copy of NetCloak to run on the same machine, with different preference settings.
  10.  
  11. When NetCloak 2.5 (the plug-in or the ACGI) runs for the first time, it looks to see if a "NetCloak Files" folder already exists. If it does not, then it creates the folder and then copies any NetCloak auxiliary files present in the application's folder into this new folder. It also copies the NetCloak Preferences file from the Preferences folder inside your System Folder into this new folder. Then it renames the old files to make it clear that they are no longer being used (by appending " (old)" to their names). 
  12.  
  13. New Security Settings
  14.  
  15. To address security concerns regarding Macintosh web server add-ons, we've added a few security options to NetCloak 2.5. You will need to review the default settings of these new options to make sure your server operates the way you expect it to.
  16.  
  17. 1. Launch the NetCloak ACGI if it is not already running.
  18.  
  19. 2. Select "Configuration" from the "Configuration" menu.
  20.  
  21. 3. Click the "Security" tab.
  22.  
  23. 4. Note that by default, the new setting 'Only process macros listed in "NetCloak.macros"' is turned ON. This means that NetCloak is prohibited from calling macros in other files. If your web site makes extensive use of the ability of NetCloak to include other files within cloaked pages, you probably want to uncheck this option.
  24.  
  25. 5. Also by default, the new setting 'Prohibit EXEC_CGI tags' is turned ON. If your site uses the EXEC_CGI tag, and you are comfortable with the security risk this implies, then uncheck this checkbox.
  26.  
  27. New Root Folder Settings
  28.  
  29. NetCloak 2.5 may reside anywhere on your server's hard disk, such as a 'cgi-bin' folder or a folder outside the web server folder heirarchy, and it will still function correctly because it allows you to tell it the location of the root folder to serve files from.
  30.  
  31. 1. Click the "Files" tab.
  32.  
  33. 2. Check the "Root Folder" path shown. If the specified folder is not your web server's root folder, click the "Root Folder" button and select your web server's root folder.
  34.  
  35. 3. If your web server supports multiple root folders, make sure the checkbox labeled "Ask Server for Root Folder" is checked. This will cause NetCloak to ask the web server for the correct root folder for each HTTP connection.
  36.  
  37. Other New Configuration Options
  38.  
  39. You should probably also check all the other configuration settings in the "Configuration" window to make sure they are what you expect. Consult the NetCloak User's Guide for more information about the new configuration settings.
  40.  
  41. Once you are satisfied with the new settings, click "OK" to close the "Configuration" window and save the settings.
  42.  
  43. If you use the NetCloak plug-in, quit the NetCloak ACGI and restart your web server.
  44.  
  45.